home *** CD-ROM | disk | FTP | other *** search
/ The Mac 1996 October / The Mac (October 1996).dmg / Applications / NetSnagger 1.1b3 / Documentation < prev    next >
Encoding:
Text File  |  1996-01-17  |  6.4 KB  |  105 lines  |  [TEXT/ttxt]

  1. NetSnagger v1.1b3
  2. This copyrighted product is free.
  3.  
  4. Introduction
  5. NetSnagger is an Internet application that works with Internet Config to simplify two internet related tasks:
  6.  
  7.     1. Retrieving files from archive digests (like the Info-Mac digest published in the     
  8.           comp.sys.mac.digest newsgroup). These documents are called "Draggers".
  9.   2. Creating double clickable desktop URLs which will utilize Internet Config
  10.       to launch the requested URL.
  11.  
  12.  NetSnagger has been tested with  System 7.5. I should, in theory, also work with 
  13. System 7.1 or later with the Drag Manager Extension. It requires Internet Config 1.1, and works best with the Anarchie ftp program by Peter Lewis. 
  14.  
  15. Features
  16. • InternetConfig support
  17. • Drag Manager Support
  18. • Automatic URL Concatenation
  19. • Double Clickable desktop URLs
  20. • Single gesture URL saves
  21.  
  22. Launchers and Draggers
  23. NetSnagger allows you to make documents which serve two similar but distinct purposes: Launchers and Draggers. A Launcher is a NetSnagger document which, when it is double clicked on the desktop, automatically launches the apropriate helper application. A Dragger is a NetSnagger
  24. document which, when opened, leaves a windows up on the desktop which serves as a 
  25. drop point for drag and drop text.
  26.  
  27. Quick Start (for Launchers)
  28. First, we will use an existing launcher to demonstrate how a NetSnagger auto-launch document works. Using the finder, open the folder named "Launchers" in the NetSnagger folder. Double click on the document named "Apple WWW". This should cause NetSnagger to open and, in turn, NetSnagger will open your http helper application as configured within Internet Config. The Apple WWW home page should soon start displaying.
  29.  
  30. Next, lets go through creating a Launcher. If the NetSnagger application is not already running, double click on the NetSnagger application in the NetSnagger folder. Once in NetSnagger, choose "New" from the file menu. This should create a new untitled menu. In the "Base URL" field, type "http://www.apple.com/". Next, choose "Save As…" from the file menu. Before saving the document, check the Auto-Launch and Auto-Close check boxes. Then, name the document "WWW Apple", and click the save button. That all. You have created a Launcher.
  31.  
  32.  
  33. Quick Start (for Draggers)
  34. In order to use NetSnagger Draggers, you will need to find a program which supports drag and drop text. Current versions of SimpleText (which you are probably using to read this), NotePad, NewsWatcher, and WordPerfect all support dragging text. 
  35.  
  36. First, make sure your Internet connection is started. Then, double click
  37. on the file named "info-mac@aol.com" which should be in the same folder as the NetSnagger program. This should launch NetSnagger and bring up a window
  38. titled, not surprisingly, "info-mac@aol.com".
  39.  
  40. Next, switch back to SimpleText (this document). Once back in SimpleText, if you cannot see the "info-mac@aol.com" window, switch over to NetSnagger and position the "info-mac@aol.com" window so that a portion of it other than the title bar is visible from SimpleText.
  41.  
  42. Now you are ready to "snag" a file using NetSnagger. The following is an info-mac path just like you will see in an info-mac digest:
  43.             /info-mac/comm/tcp
  44.  
  45. Select the path (the underlined one just above) and hold the mouse over the selection so that the arrow (not the I-beam) cursor is visible. Then, drag the text selection onto the "info-mac@aol.com" NetSnagger window and drop it.
  46.  
  47. Assuming you have Anarchie installed as your ftp server, Anarchie will be launched and a listing of the the info-mac "tcp" directory will be displayed.
  48.  
  49. Note: There are two modifier keys you can hold down when dragging. When you hold down shift, the url will be saved as a launcher into the AutoSave Folder specified in the prefrences. When you hold down command, a save file dialog will come forward so that you can save the url interactively.
  50.  
  51. File Format
  52. NetSnagger uses a text file format for saving URLs to disk. In each NetSnagger file it places one URL along with other information. In order to customize URL files so that you can make them auto-launch and auto-close, you will need to edit the NetSnagger file with a text editor (like SimpleText). A NetSnagger file opened with a text editor looks like this:
  53.  
  54.        [50 50 150 350]Y:N:2:/umich/util:ftp://mirror.aol.com/mac/
  55.  
  56. The items inside the angle brackets describe the window position when the file was last saved. This is an optional item.
  57.  
  58. The next two items are the auto-launch and auto-close settings respectively. These should be set to 'Y' or 'N'. In this example, this file indicates that it should be automatically launched when opened, but not automatically closed.
  59.  
  60. The next item is the number of forward slashes ('/') to skip. When a URL is launched, or a portion of a URL path is dropped on a NetSnagger window the "Base URL" portion is concatinated with the "Sub URL" portion. When the skip slashes popup is set to something other than 0, NetSnagger skipps the indicated number of slashes. This is useful for archive mirror sites whose pathname is different from that of the digest. For example, the umich digest paths usually begin with "/umich/" but aol has seen fit to place their mirror in "/pub/mac". By using the skip slashed option, you can drag a umich path into the "umich@aol.com" mirror and have the correct file "snagged" for you automatically.
  61.  
  62. The forth item is the "Sub URL" portion from the NetSnagger document window.
  63.  
  64. The final item is the "Base URL" portion.
  65.  
  66. Currently only one URL is supported per NetSnagger file.
  67.  
  68. Support
  69. Support is available via email. Please email questions and bug reports to: 
  70.                 rmore@onramp.net
  71.  
  72. Current versions as well as additional information is available from:
  73.           http://rampages.onramp.net/~rmore/netsnagger.html
  74.  
  75. Or from the launcher named "NetSnagger WWW" in the Launchers folder.
  76.  
  77.  
  78. Future Plans
  79. Coming soon should be:
  80.     • URL list windows.
  81.     • Decent Icons (please donate less ugly icons)
  82.     • Whatever users can convince me to implement
  83.  
  84. Postcards
  85. Thank you for using NetSnagger. If you use Anarchie and have not paid for it, please make sure to pay Peter Lewis for his hard work. If you like NetSnagger, please send me a post card if you wish.
  86.  
  87. Please send the postcard to:
  88.  
  89.                 Rod Morehead
  90.                 1230 Settlers Way
  91.                 Lewisville, Texas 75067
  92.                 U.S.A.
  93.  
  94.  
  95. It would also help me if you would send the following information:
  96.         Name
  97.         Postal Address
  98.         Email Address
  99.         Mac Model
  100.         Mac System Software Version
  101.  
  102. Thanks,
  103.                     Rod Morehead
  104.                     rmore@onramp.net
  105.             http://rampages.onramp.net/~rmore/